home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_cnvt / ntx2dbf / read.me < prev    next >
Encoding:
Text File  |  1993-01-04  |  3.1 KB  |  57 lines
  1. The zip file :NTX.ZIP should contain the following files:
  2. NTXCAT.PRG  - source for NTXCAT.EXE
  3. NTXFUNC.PRG - source for user-defined function FNTXCAT
  4. NTXCAT.EXE  - executable version of index catalogue program
  5. LISTNTX.PRG - source for LISTNTX.EXE
  6. LISTNTX.EXE - executable version of index catalogue listing program
  7. UDFS.PRG    - source for 2(two) user-defined functions I use in these programs
  8. NTX.LST     - sample output file from LISTNTX
  9. READ.ME     - this file
  10.  
  11.     This program was designed to aid the system developer & administrator
  12. of Clipper based systems. The problem is that when you have multiple index
  13. files for each database in your system, it is hard to tell what database the
  14. index is associated with. Neither Clipper or Dbase includes the database name
  15. used in the actual index file.
  16.  
  17.    After examining the problem, I came up with the following solution. The
  18. first 1024 bytes in all .ntx files is used to store the index expression as
  19. well as some proprietary information unknown to myself. The actual index 
  20. information does not start until byte 1025. After careful testing, I 
  21. determined that the 16 bytes prior to 1025,1008 thru 1024, were a safe place
  22. to store some additional information. What NTXCAT actually does is replace bytes
  23. 1008 thru 1015 with a database file name.       
  24.  
  25.     The program starts by reading a directory of all .ntx files in the current
  26. directory. It then presents each file name, one at a time, and prompts for a
  27. database name to be inserted into that .ntx file. This works just fine for an
  28. initial start of the cataloging process. However, whenever you index or re-index
  29. this information is lost, since Clipper rewrites the index file on top of the
  30. old one.
  31.   
  32.     This is where the user-defined function FNTXCAT comes in. The idea is that
  33. everywhere in your program where you do an index or re-index you should then
  34. call this function which will insert the database name in the index file.
  35.  
  36.     Now, you may wonder, that I have a database file name in the index file
  37. what I am going to do with it? Well, thats where LISTNTX.EXE comes in. Basically
  38. that program will read all .ntx files in the current directory and create a text
  39. file showing:index file name, index expression, & database name inserted by
  40. NTXCAT. You are prompted for the file name on program execution. This text file
  41. may then be viewed or printed out at your discretion.
  42.  
  43.     This is one of my first attempts at writing a major utility for Clipper
  44. systems and therefore do not imply any expertise on the subject. Even though I 
  45. have tested this program thouroughly, I cannot guarentee any results. However,
  46. I would appreciate any feedback, good or bad, on this idea. I can be reached by
  47. electonic mail at any of the following places:
  48.  
  49.                               Contech BBS - (301)340-2212
  50.                               Programmers Corner - (301)995-3744
  51.                               Cbug BBS - (301)730-5624
  52.                               Compuserve - 73257,1737                
  53.                               
  54. Good Luck & Happy Clippering!
  55.  
  56. Gary Blatt
  57.